feat(linux-wallpaperengine-controller): improve panel controls, extra properties, and configuration handling by PaloMiku · Pull Request #596 · noctalia-dev/noctalia-plugins

PaloMiku · 2026-04-08T12:30:24Z

Summary

Reworked the wallpaper panel with search, resolution filtering, pagination, richer sidebar metadata, clickable workshop links, and clearer engine status / start-stop controls.
Added extra property inspection and editing support, plus a compatibility quick-check flow that can scan wallpapers and mark entries that may fail.
Expanded plugin configuration with icon color, clamp mode, no-automute audio behavior, better runtime option persistence, and broader localization updates.

What Changed

Added wallpaper list improvements:
- search by wallpaper name or ID
- resolution filtering
- paginated grid rendering for better performance on large libraries
- updated badge layout and clearer sidebar metadata
Added sidebar quality-of-life improvements:
- clickable workshop ID link that opens the corresponding Steam Workshop page
- runtime status badge in the panel header
- start / stop toggle button in the header
Added extra properties support:
- parse linux-wallpaperengine --list-properties
- render editable supported properties in the sidebar
- persist per-wallpaper property overrides
- normalize known property labels such as theme color
Added compatibility quick check:
- scan all wallpapers for extra property compatibility
- mark wallpapers with a may fail badge
- show a completion toast with scanned / flagged counts
Expanded settings:
- icon color customization
- default clamp mode
- keep wallpaper audio playing while other applications output sound
- improved FPS / volume handling and related labels
Cleaned up runtime configuration behavior:
- aligned global-only runtime options with global persistence
- removed stale per-screen runtime option remnants
- kept scaling as per-screen while treating clamp as a single global engine argument
Refreshed README, preview assets, and translations across English, Simplified Chinese, Traditional Chinese, Japanese, and Russian.

Why

The panel had become difficult to use with large wallpaper libraries and did not expose enough runtime controls or wallpaper metadata.
linux-wallpaperengine supports useful runtime flags and property inspection that were not surfaced in the plugin UI.
Several settings and runtime behaviors were inconsistent between UI state, saved configuration, and actual engine command construction; this update makes those paths more predictable.

Preview Panel (New):

…sian localization

… to 1.1.0

…d static badge and unit translations

… multiple languages

…update translations for multiple languages

Copilot

Pull request overview

This PR improves the wallpaper selection panel’s UX and localization by adding toast feedback for engine actions, expanding translations (including a new Russian locale), and refining panel UI elements (filters, badges, and multi-display targeting).

Changes:

Add localized toast notifications for reload/stop actions (including “reload skipped”).
Enhance the panel UI with resolution filtering, clearer badges/labels, and an updated multi-display target selector.
Expand i18n strings across EN/JA/ZH + add RU, and localize unit suffixes in settings.

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
linux-wallpaperengine-controller/Main.qml	Adds optional toast feedback to `reload()` / `stopAll()` and imports Toast service.
linux-wallpaperengine-controller/BarWidget.qml	Triggers toast-enabled reload/stop from the bar widget context actions.
linux-wallpaperengine-controller/Panel.qml	Adds resolution filtering UI, new badges, refactors apply-target UI, and updates empty-state messaging.
linux-wallpaperengine-controller/Settings.qml	Localizes FPS/% unit suffixes via translation keys.
linux-wallpaperengine-controller/manifest.json	Bumps plugin version to 1.1.0.
linux-wallpaperengine-controller/i18n/en.json	Adds toast + new panel strings, updates wording, adds unit strings.
linux-wallpaperengine-controller/i18n/ja.json	Adds toast + new panel strings, updates wording, adds unit strings.
linux-wallpaperengine-controller/i18n/zh-CN.json	Adds toast + new panel strings, updates wording, adds unit strings.
linux-wallpaperengine-controller/i18n/zh-TW.json	Adds toast + new panel strings, updates wording, adds unit strings.
linux-wallpaperengine-controller/i18n/ru.json	New full Russian translation coverage including toast + units.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…sibility logic

…istency

…value handling and UI elements

… for clarity and feature details

…ments for better clarity

PaloMiku · 2026-04-09T11:44:39Z

I think it's pretty good now (current version 1.1.2).

spiros132

Looks good to me! :D

@ItsLemmy

Cleboost · 2026-04-10T07:28:05Z

 {
  "id": "linux-wallpaperengine-controller",
  "name": "Linux WallpaperEngine Controller",
-  "version": "1.0.6",


version is sus?
the sementic release is normally done with minor and major patches. it looks like you're doing two patches and one minor. when a minor is made in a pr it includes the patches

I developed this PR iteratively: first a few small fixes, then a larger UI improvement.

I previously conducted multiple rounds of small-scale testing in my personal repository, resulting in multiple version iterations.

I won't change it frequently after that

okay mb 👌

- Introduced a toggle for enabling an extra properties editor in the settings. - Updated the settings UI to include the new toggle and reorganized some sections for clarity. - Added new translations for the extra properties editor feature in multiple languages. - Implemented a new script to scan wallpaper directories for compatibility with extra properties. - Updated the manifest to include the new configuration option for the extra properties editor.

…nd update related UI elements

…lements

…category title in translations

…bel translation

…ompatibility scan logging feat(settings): update default settings handling for volume, mute, audio effects, and mouse/parallax options fix(i18n): update translations for compatibility check messages and search placeholders in multiple languages

…ates

…translations

github-actions · 2026-04-10T16:21:25Z

Automatic Code Quality Review

File: linux-wallpaperengine-controller/Panel.qml

(H) Line 543: Use translations instead of hardcoded text. Instead of: "Example Label". To: pluginApi?.tr("panel.example-label")

+          label: "",

PaloMiku · 2026-04-10T16:25:54Z

There have been a lot of feature and design updates in this time, so I need to turn it into a draft for now

New design overview:

Once completed, I will provide a comprehensive list of changes.

Copilot

Pull request overview

Copilot reviewed 12 out of 13 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…items

…k notes

PaloMiku · 2026-04-10T16:59:42Z

Major Update Overview (April 11)

Now, the plugin can handle most of the custom configurations from the source wallpaper.

A new one-click compatibility quick check now helps users quickly determine which wallpapers are basically unusable.

Now with the pagination feature, displaying 24 wallpapers per page reduces user performance consumption and wallpaper search time.

spiros132

Some minor feedback about the PR :D

Also it looks like the Panel component has become very huge, I would recommend maybe for the next release to split it up into different components / files to make it easier to read and more organized.

spiros132 · 2026-04-10T16:52:04Z

This one has one more line added and one more line removed. Do double check that the translations match correctly with each other.

You're right, but since my native language is not a language other than Chinese, the quality of the corresponding translation may not be very good

spiros132 · 2026-04-10T17:03:29Z

-                clip: true
+                spacing: Style.marginS
+
+                GridView {


Is it possible to use the noctalia NGridView instead of the qml one? To keep it more consistent with the noctalia look.

Great, while reviewing the NGridView documentation, I found that card scrolling calculations can also be based on availableWidth, and it's more stable

…ation; update translations for status and reload actions

spiros132

Looks good to me. Thank you for the PR! :D

@ItsLemmy

PaloMiku added 5 commits April 8, 2026 19:27

fix(panel): update panel titles and button texts for clarity; add Rus…

79f2a5c

…sian localization

feat(panel): enhance display options and localization; update version…

5ab8ee4

… to 1.1.0

feat(panel, settings, i18n): improve localization and UI elements; ad…

0075db1

…d static badge and unit translations

feat(panel, i18n): update sectionAudio labels for improved clarity in…

36f7e67

… multiple languages

feat(panel, i18n): add resolution filtering and toast notifications; …

1897a33

…update translations for multiple languages

Copilot AI review requested due to automatic review settings April 8, 2026 12:30

Copilot started reviewing on behalf of PaloMiku April 8, 2026 12:31 View session

Copilot AI reviewed Apr 8, 2026

View reviewed changes

PaloMiku added 6 commits April 8, 2026 20:39

fix(panel): remove unused resolutionText function; update dropdown vi…

63c7cf9

…sibility logic

fix(panel): update _applyAllDisplays property and improve layout cons…

313f637

…istency

feat(panel, settings): enhance volume and fps settings with improved …

31fb9b1

…value handling and UI elements

chore: update version to 1.1.1 in manifest.json and improve README.md…

35f5994

… for clarity and feature details

docs: update README.md title and description for clarity

b49130e

feat(settings, panel): add icon color customization and update UI ele…

e40b00d

…ments for better clarity

fix(Main.qml): remove unnecessary import of qs.Services.System

b713771

spiros132 reviewed Apr 9, 2026

View reviewed changes

Cleboost reviewed Apr 10, 2026

View reviewed changes

Cleboost approved these changes Apr 10, 2026

View reviewed changes

PaloMiku added 7 commits April 10, 2026 18:33

feat(settings): add 'Do not mute when other apps play audio' option a…

e0dc5ca

…nd update related UI elements

feat(settings): add default clamp mode option and update related UI e…

ae9c7a8

…lements

feat(panel): add theme color property label and update compatibility …

0537736

…category title in translations

fix(panel): normalize key handling and update theme color property la…

a25c50e

…bel translation

feat(panel): add engine status badge with translations for various st…

b07a3ca

…ates

PaloMiku marked this pull request as draft April 10, 2026 16:19

feat(panel): update engine control buttons and add start action with …

13b1071

…translations

PaloMiku requested a review from Copilot April 10, 2026 16:20

Copilot started reviewing on behalf of PaloMiku April 10, 2026 16:21 View session

Copilot AI reviewed Apr 10, 2026

View reviewed changes

Comment thread linux-wallpaperengine-controller/Main.qml

Comment thread linux-wallpaperengine-controller/Main.qml

Comment thread linux-wallpaperengine-controller/Panel.qml

Comment thread linux-wallpaperengine-controller/Panel.qml

PaloMiku added 2 commits April 11, 2026 00:35

feat(panel): update start/stop actions and add translations for menu …

2ab0e3f

…items

fix(panel): update compatibility scan command to use bash instead of sh

40bc282

PaloMiku changed the title ~~feat(Linux WallpaperEngine Controller) Enhance panel localization and UI clarity across multiple languages~~ feat(linux-wallpaperengine-controller): improve panel controls, extra properties, and configuration handling Apr 10, 2026

docs(README): enhance feature descriptions and add compatibility chec…

7b253ce

…k notes

PaloMiku marked this pull request as ready for review April 10, 2026 16:49

PaloMiku requested a review from spiros132 April 10, 2026 16:49

spiros132 reviewed Apr 10, 2026

View reviewed changes

feat(panel): replace GridView with NGridView and adjust column calcul…

9169988

…ation; update translations for status and reload actions

PaloMiku requested a review from spiros132 April 10, 2026 17:20

spiros132 reviewed Apr 10, 2026

View reviewed changes

Cleboost approved these changes Apr 10, 2026

View reviewed changes

spiros132 merged commit 066e3d3 into noctalia-dev:main Apr 13, 2026
2 checks passed

Conversation

PaloMiku commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What Changed

Why

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

PaloMiku commented Apr 9, 2026

Uh oh!

spiros132 left a comment

Choose a reason for hiding this comment

Uh oh!

Cleboost Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

PaloMiku Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Cleboost Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Apr 10, 2026

Automatic Code Quality Review

File: linux-wallpaperengine-controller/Panel.qml

Uh oh!

PaloMiku commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

PaloMiku commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Major Update Overview (April 11)

Uh oh!

spiros132 left a comment

Choose a reason for hiding this comment

Uh oh!

spiros132 Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

PaloMiku Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

spiros132 Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

PaloMiku Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

spiros132 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

PaloMiku commented Apr 8, 2026 •

edited

Loading

PaloMiku commented Apr 10, 2026 •

edited

Loading

PaloMiku commented Apr 10, 2026 •

edited

Loading

PaloMiku Apr 10, 2026 •

edited

Loading